.. _ecmPtmSt_GetRunStepInfo:

ecmPtmSt_GetRunStepInfo
=======================
-----------------------


SYNOPSIS
--------


.. code-block:: none

  t_success   ecmPtmSt_GetRunStepInfo(
    t_i32  NetID,
    t_i32  PtmMapIndex,
    t_i32  *RunStepCount,
    t_i32  *RunStepSts,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 이 함수는 PtmMapIndex로 지정된 PT-Motion 맵의 동작상태를 반환합니다.
 



PARAMETER
---------


- NetID : Network 번호

- PtmMapIndex : 이송스텝을 등록하고자 하는 대상 PT-Motion 맵 인덱스.

- RunStepCount : 이 포인터를 통해서 현재 실행되고 있는 이송스텝의 일련번호를 반환한다. 이송스텝의 일련번호는 1부터 매겨지는 스텝의 등록 순서를 말합니다. 일련 번호를 반환 받지 않으려면 이 매개변수의 값을 NULL로 설정합니다.

- :ref:`RunStepSts  <ecat_enum_EEcmPtmCmdItemSts>`  : 이 포인터를 통해서 현재 실행되고 있는 이송스텝의 명령 수행 상태를 반환합니다. 명령 수행 상태 값을 반환 받지 않으려면 이 매개변수의 값을 NULL로 설정 합니다.

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 이 리턴값은 불 형(Boolean Type) 을 가지고 있습니다.
 
+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+


.. seealso::
  :ref:`ecmPtmCtl_Begin EXAMPLE 참고  <ecmPtmCtl_Begin>`